NetworkSpecification<specification‑number>

String (transport‑type,enabled|disabled,listener‑port[,interface])

Not specified

Purpose

The NetworkSpecification<specification‑number> parameter enables a primary database server node with the required connection parameters to listen for incoming connections from secondary database server nodes. The <specification‑number> part of the parameter name is a sequential number starting from 1. Multiple network specifications must have contiguous sequence numbers, as shown in the following example.

NetworkSpecification1 = TcpIp,disabled,5999
NetworkSpecification2 = TcpIp,enabled,5100,NIC1.hosta.ja.net
NetworkSpecification3 = TcpIpv6,enabled,5200,::1

The values in an SDS network specification are interpreted as follows.

  1. transport‑type

    Specifies the transport type to connect to the server node, which is TcpIP, TcpIPv4, or TcpIPv6.

    The transport‑type literal value is not case-sensitive. TcpIP is synonymous with TcpIPv4.

  2. enabled|disabled

    This value specifies whether the network state is currently enabled or disabled. (By setting this value to disabled, you can temporarily disable the network specification without having to renumber the unique identifiers of other NetworkSpecification<specification‑number> parameters in the [ConnectionParams] section.)

  3. listener‑port

    This value specifies the TCP port number or service name used to listen for and accept in‑bound connections.

    Select a unique port number in the range 1024 through 65534 that does not conflict with other TCP port number (or TCP service) usages on the machine.

    A port name cannot begin with a numeric value.

    Internet Assigned Numbers Authority (IANA) port numbers in the range 0 through 1023 are reserved, those in the range 1024 through 49151 are registered and may have been assigned to specific applications, and those in the range 49152 through 65534 are dynamic, or set aside for private use.

  4. [interface]

    You can specify the interface value as a host name or an IP address. If you use an IP address, the address must be in an appropriate format for the specified transport‑type value.

No spaces are allowed in the server network specification.

Parameter is read when …

An SDS primary service is next initialized; that is, you can start and stop the service without stopping the server.